类 FoxitPDFSDKPython3.Signature 继承关系图:

Public 成员函数
def	Signature (document, sig_field_dict)
	构造函数，从签名字段字典创建。更多...

def	ClearSignedData ()
	如果当前签名已签名且验证有效，清除数据和外观。更多...

def	EnableEmbedFont (enable_embed_font)
	启用或禁用嵌入字体。更多...

def	EnableIncrementalSaveForFirstSigning (enable_incremental_save)
	启用或禁用首次签名的增量保存。用户应在调用函数FoxitPDFSDKPython3.Signature.StartSign 之前调用此函数。默认值：false。更多...

def	GenerateAppearance ()
	生成未签名签名的外观。更多...

def	GetAppearanceFlags ()
	获取签名外观标志。更多...

def	GetBitmap ()
	获取用于签名外观的位图。更多...

def	GetByteRangeArray (out_byte_range_array)
	获取字节范围数据，包括4个元素。更多...

def	GetCert (index)
	通过索引从当前签名的证书链中获取证书。更多...

def	GetCertCount ()
	获取当前签名证书链中的证书数量。更多...

def	GetCertificateInfo (key)
	获取证书信息。更多...

def	GetDocPermission ()
	获取当前签名的文档权限。更多...

def	GetDocument ()
	获取当前签名所属的PDF文档。更多...

def	GetFieldMDPAction ()
	获取FieldMDP（"MDP"表示修改检测和预防）操作类型。更多...

def	GetFieldMDPActionFields ()
	获取用于FieldMDP操作的字段名称数组。更多...

def	GetFilter ()
	获取过滤器。更多...

def	GetKeyLabel (label_name)
	获取指定键标签的字符串。更多...

def	GetKeyValue (key)
	获取指定键名的字符串值。更多...

def	GetPAdESLevel ()
	获取PAdES级别。更多...

def	GetPagingSealGroupElements ()
	获取当前分页印章签名的组元素。更多...

def	GetPagingSealSignature ()
	获取分页印章签名。更多...

def	GetSignatureDict ()
	获取签名字典。更多...

def	GetSignatureType ()
	获取签名类型。更多...

def	GetSignedVersionDocument (file_path)
	获取当前签名签署时的已签名版本中的PDF文档。更多...

def	GetSignTime ()
	获取签名时间。更多...

def	GetState ()
	获取当前状态。更多...

def	GetSubFilter ()
	获取子过滤器。更多...

def	IsEmpty ()
	检查当前对象是否为空。更多...

def	IsSigned ()
	检查当前签名是否已签名。更多...

def	IsTimeStamp ()
	检查当前签名是否为时间戳签名。更多...

def	SetAppearanceContent (appearance_content)
	为已签名签名外观设置自定义外观内容（作为低级绘图操作命令）。更多...

def	SetAppearanceFlags (appearance_flags)
	设置签名外观标志。更多...

def	SetBitmap (bitmap)
	为签名外观设置位图。更多...

def	SetCertChain (cert_chain)
	设置证书链。更多...

def	SetCustomObject (key, pdf_object)
	为签名字典设置自定义PDF对象。更多...

def	SetDefaultContentsLength (default_length)
	设置表示签名值（称为已签名数据）的签名内容的默认长度。更多...

def	SetDocPermission (permission)
	设置当前签名的文档权限。更多...

def	SetFieldMDPActionFields (action, field_array)
	设置FieldMDP（"MDP"表示修改检测和预防）操作名称数组。更多...

def	SetFilter (filter)
	设置过滤器。更多...

def	SetImage (file_path, frame_index)
	使用指定帧索引为签名外观设置图像。更多...

def	SetImage (image, frame_index)
	为签名外观设置图像，指定帧索引。更多...

def	SetKeyLabel (label_name, label_value)
	设置指定键标签的字符串。更多...

def	SetKeyValue (key, value)
	设置指定键名的字符串值。更多...

def	SetSignTime (sign_time)
	设置签名时间。更多...

def	SetSubFilter (sub_filter)
	设置子过滤器。更多...

def	StartSign (cert_file_stream, cert_password, digest_algorithm, save_path, client_data, pause)
	如果当前签名是未签名的，开始签名当前签名。更多...

def	StartSign (cert_file_stream, cert_password, digest_algorithm, stream_callback, client_data, pause)
	如果当前签名为未签名状态，则开始签名当前签名。更多...

def	StartSign (cert_path, cert_password, digest_algorithm, stream_callback, client_data, pause)
	如果当前签名为未签名状态，则开始签名当前签名。更多...

def	StartVerify (client_data, pause)
	如果当前签名已签名，开始验证当前签名的完整性。更多...

Public 成员函数继承自 FoxitPDFSDKPython3.Field
def	Field (field)
	构造函数，使用另一个表单字段对象。更多...

def	GetAlignment ()
	获取对齐值。更多...

def	GetAlternateName ()
	获取备用名称。更多...

def	GetControl (page, index)
	在指定PDF页面中通过索引获取表单控件。更多...

def	GetControlCount ()
	获取表单控件数量。更多...

def	GetControlCount (page)
	获取指定PDF页面中的表单控件数量。更多...

def	GetDefaultAppearance ()
	获取默认外观数据。更多...

def	GetDefaultValue ()
	获取默认值。更多...

def	GetDefaultValueObj ()
	获取字段默认值的PDF对象。更多...

def	GetDict ()
	获取当前对象的PDF字典。更多...

def	GetFlags ()
	获取字段标志。更多...

def	GetInheritedAttribute (attribute_name)
	获取指定属性的PDF对象，该属性可能从字段树中的祖先节点继承。更多...

def	GetMappingName ()
	获取映射名称。更多...

def	GetMaxLength ()
	获取字段文本的最大长度（以字符为单位）。更多...

def	GetName ()
	获取字段名称。更多...

def	GetOptions ()
	获取列表框或组合框的选项。更多...

def	GetTopVisibleIndex ()
	获取可滚动列表框的选项顶部索引。更多...

def	GetType ()
	获取字段类型。更多...

def	GetValue ()
	获取值。更多...

def	GetValueObj ()
	获取字段值的PDF对象。更多...

def	Reset ()
	将当前字段中的数据重置为其默认值。（不支持签名字段）更多...

def	SetAlignment (alignment)
	设置表单的对齐属性，作为文档范围的默认值。（不支持签名字段）更多...

def	SetAlternateName (alternate_name)
	设置备用名称。（不支持签名字段）更多...

def	SetDefaultAppearance (default_ap)
	设置默认外观数据。更多...

def	SetDefaultValue (value)
	设置默认值。更多...

def	SetFlags (flags)
	设置字段标志。更多...

def	SetMappingName (name)
	设置映射名称。（不支持签名字段）更多...

def	SetMaxLength (max_length)
	设置字段文本的最大长度（以字符为单位）。更多...

def	SetOptions (option_array)
	设置列表框或组合框的选项。更多...

def	SetTopVisibleIndex (index)
	设置可滚动列表框的顶部索引。更多...

def	SetValue (value)
	设置值。更多...

静态 Public 属性
	e_APFlagBitmap = _fsdk.Signature_e_APFlagBitmap
	如果设置，在签名外观上显示位图。

	e_APFlagDN = _fsdk.Signature_e_APFlagDN
	如果设置，在签名外观上显示专有名称。

	e_APFlagFoxitEditorFlag = _fsdk.Signature_e_APFlagFoxitEditorFlag
	如果设置，在签名外观上显示Foxit Editor内容。

	e_APFlagFoxitFlag = _fsdk.Signature_e_APFlagFoxitFlag
	如果设置，在签名外观上显示Foxit标志。

	e_APFlagLabel = _fsdk.Signature_e_APFlagLabel
	如果设置，在签名外观上显示标签。

	e_APFlagLocation = _fsdk.Signature_e_APFlagLocation
	如果设置，在签名外观上显示位置。

	e_APFlagProducer = _fsdk.Signature_e_APFlagProducer
	如果设置，在签名外观上显示生产者内容。

	e_APFlagReason = _fsdk.Signature_e_APFlagReason
	如果设置，在签名外观上显示原因。

	e_APFlagSigner = _fsdk.Signature_e_APFlagSigner
	如果设置，在签名外观上显示签名者。

	e_APFlagSigningTime = _fsdk.Signature_e_APFlagSigningTime
	如果设置，在签名外观上显示签名时间。

	e_APFlagText = _fsdk.Signature_e_APFlagText
	如果设置，在签名外观上显示文本内容。

	e_DigestSHA1 = _fsdk.Signature_e_DigestSHA1
	签名摘要算法：sha1算法。

	e_DigestSHA256 = _fsdk.Signature_e_DigestSHA256
	签名摘要算法：sha256算法。

	e_DigestSHA384 = _fsdk.Signature_e_DigestSHA384
	签名摘要算法：sha384算法。

	e_DigestSHA512 = _fsdk.Signature_e_DigestSHA512
	签名摘要算法：sha512算法。

	e_DocPermFillingFormAndSigning = _fsdk.Signature_e_DocPermFillingFormAndSigning
	允许的更改是填写表单、实例化页面模板和签名。其他更改将使签名无效。

	e_DocPermFillingFormSigningAndAnnotating = _fsdk.Signature_e_DocPermFillingFormSigningAndAnnotating
	允许的更改与2相同，以及创建、删除和修改注释。其他更改将使签名无效。

	e_DocPermNoChangesAllowed = _fsdk.Signature_e_DocPermNoChangesAllowed
	不允许对PDF文档（被签名签署）进行任何更改。对此类PDF文档的任何更改都将使签名无效。

	e_DocPermUnrestricted = _fsdk.Signature_e_DocPermUnrestricted
	无限制。

	e_FieldMDPActionAll = _fsdk.Signature_e_FieldMDPActionAll
	所有表单字段的标志将被设置为只读。

	e_FieldMDPActionExclude = _fsdk.Signature_e_FieldMDPActionExclude
	表单字段（除指定表单字段外）的标志将被设置为只读。更多...

	e_FieldMDPActionInclude = _fsdk.Signature_e_FieldMDPActionInclude
	指定表单字段的标志将被设置为只读。更多...

	e_FieldMDPActionNone = _fsdk.Signature_e_FieldMDPActionNone
	无字段MDP操作。

	e_KeyNameContactInfo = _fsdk.Signature_e_KeyNameContactInfo
	签名键名：联系信息。

	e_KeyNameDN = _fsdk.Signature_e_KeyNameDN
	签名键名：专有名称。

	e_KeyNameLocation = _fsdk.Signature_e_KeyNameLocation
	签名键名：位置。

	e_KeyNameProducer = _fsdk.Signature_e_KeyNameProducer
	签名键名：生产者内容。

	e_KeyNameReason = _fsdk.Signature_e_KeyNameReason
	签名键名：原因。

	e_KeyNameSigner = _fsdk.Signature_e_KeyNameSigner
	签名键名：签名者。

	e_KeyNameText = _fsdk.Signature_e_KeyNameText
	签名键名：文本内容。

	e_LabelNameDN = _fsdk.Signature_e_LabelNameDN
	专有名称的签名键名。更多...

	e_LabelNameLocation = _fsdk.Signature_e_LabelNameLocation
	位置的签名标签名称。更多...

	e_LabelNameProducer = _fsdk.Signature_e_LabelNameProducer
	生产者名称的签名键名。更多...

	e_LabelNameReason = _fsdk.Signature_e_LabelNameReason
	原因的签名标签名称。更多...

	e_LabelNameSigner = _fsdk.Signature_e_LabelNameSigner
	签名者的签名标签名称。更多...

	e_LabelNameSignTime = _fsdk.Signature_e_LabelNameSignTime
	签名时间的签名标签名称。更多...

	e_PAdESLevelBB = _fsdk.Signature_e_PAdESLevelBB
	PAdES级别：B-B。

	e_PAdESLevelBLT = _fsdk.Signature_e_PAdESLevelBLT
	PAdES级别：B-LT。

	e_PAdESLevelBLTA = _fsdk.Signature_e_PAdESLevelBLTA
	PAdES级别：B-LTA。

	e_PAdESLevelBT = _fsdk.Signature_e_PAdESLevelBT
	PAdES级别：B-T。

	e_PAdESLevelNone = _fsdk.Signature_e_PAdESLevelNone
	PAdES级别：无。

	e_PAdESLevelNotPAdES = _fsdk.Signature_e_PAdESLevelNotPAdES
	不是PAdES签名。

	e_SignatureTypeOrdinary = _fsdk.Signature_e_SignatureTypeOrdinary
	签名类型：普通。

	e_SignatureTypePagingSeal = _fsdk.Signature_e_SignatureTypePagingSeal
	签名类型：分页印章。

	e_SignatureTypeTimeStamp = _fsdk.Signature_e_SignatureTypeTimeStamp
	签名类型：时间戳。

	e_StateCertCannotGetVRI = _fsdk.Signature_e_StateCertCannotGetVRI
	无法获取验证相关信息。

	e_StateNoSignData = _fsdk.Signature_e_StateNoSignData
	签名没有任何用于签名的数据。这意味着签名字典中没有"V"条目。

	e_StateSigned = _fsdk.Signature_e_StateSigned
	已签名的签名。

	e_StateUnknown = _fsdk.Signature_e_StateUnknown
	未知签名。

	e_StateUnsigned = _fsdk.Signature_e_StateUnsigned
	未签名的签名。

	e_StateVerifyChange = _fsdk.Signature_e_StateVerifyChange
	文档在签名范围内已被更改。（这表示签名无效。）

	e_StateVerifyChangeIllegal = _fsdk.Signature_e_StateVerifyChangeIllegal
	文档在签名范围之外已被更改，并且更改使签名无效。

	e_StateVerifyChangeLegal = _fsdk.Signature_e_StateVerifyChangeLegal
	文档在签名范围之外已被更改，但更改是被允许的。

	e_StateVerifyErrorByteRange = _fsdk.Signature_e_StateVerifyErrorByteRange
	非预期字节范围。

	e_StateVerifyErrorData = _fsdk.Signature_e_StateVerifyErrorData
	签名数据已损坏（这意味着签名数据无法正确解析）。

	e_StateVerifyIncredible = _fsdk.Signature_e_StateVerifyIncredible
	签名不可信（包含攻击性）。

	e_StateVerifyInvalid = _fsdk.Signature_e_StateVerifyInvalid
	签名的验证状态无效。

	e_StateVerifyIssueCurrent = _fsdk.Signature_e_StateVerifyIssueCurrent
	验证的发行者是当前发行者。

	e_StateVerifyIssueExpire = _fsdk.Signature_e_StateVerifyIssueExpire
	用于验证发行者的证书已过期。

	e_StateVerifyIssueRevoke = _fsdk.Signature_e_StateVerifyIssueRevoke
	用于验证发行者的证书已被撤销。

	e_StateVerifyIssueUncheck = _fsdk.Signature_e_StateVerifyIssueUncheck
	不检查发行者。

	e_StateVerifyIssueUnknown = _fsdk.Signature_e_StateVerifyIssueUnknown
	发行者的验证状态未知。

	e_StateVerifyIssueValid = _fsdk.Signature_e_StateVerifyIssueValid
	发行者的验证状态有效。

	e_StateVerifyNoChange = _fsdk.Signature_e_StateVerifyNoChange
	文档在签名范围内未被更改。

	e_StateVerifyNoSupportWay = _fsdk.Signature_e_StateVerifyNoSupportWay
	不支持的签名。

	e_StateVerifyTimestampDoc = _fsdk.Signature_e_StateVerifyTimestampDoc
	签名是时间戳签名。

	e_StateVerifyTimestampExpire = _fsdk.Signature_e_StateVerifyTimestampExpire
	时间戳的验证状态已过期。

	e_StateVerifyTimestampInvalid = _fsdk.Signature_e_StateVerifyTimestampInvalid
	时间戳的验证状态无效。

	e_StateVerifyTimestampIssueUnknown = _fsdk.Signature_e_StateVerifyTimestampIssueUnknown
	时间戳发行者的验证状态未知。

	e_StateVerifyTimestampIssueValid = _fsdk.Signature_e_StateVerifyTimestampIssueValid
	时间戳发行者的验证状态有效。

	e_StateVerifyTimestampNone = _fsdk.Signature_e_StateVerifyTimestampNone
	没有时间戳或不检查时间戳。

	e_StateVerifyTimestampTimeBefore = _fsdk.Signature_e_StateVerifyTimestampTimeBefore
	时间戳时间的验证状态有效，因为时间在过期日期之前。

	e_StateVerifyTimestampValid = _fsdk.Signature_e_StateVerifyTimestampValid
	时间戳的验证状态有效。

	e_StateVerifyValid = _fsdk.Signature_e_StateVerifyValid
	签名的验证状态有效。

静态 Public 属性继承自 FoxitPDFSDKPython3.Field
	e_FlagButtonNoToggleToOff = _fsdk.Field_e_FlagButtonNoToggleToOff
	（仅对单选按钮有用）如果设置，必须始终选择一个单选按钮；点击当前选择的按钮没有效果。如果清除，点击选择的按钮会取消选择它，不留下任何选择的按钮。

	e_FlagButtonRadiosInUnison = _fsdk.Field_e_FlagButtonRadiosInUnison
	（仅对单选按钮有用）如果设置，单选按钮字段内使用相同开启状态值的一组单选按钮将一致地开启和关闭；也就是如果一个被选中，它们都被选中。如果清除，按钮是互斥的。

	e_FlagChoiceCommitOnSelChange = _fsdk.Field_e_FlagChoiceCommitOnSelChange
	（仅对选择字段有用）如果设置，一旦用指点设备进行选择，新值就立即提交；如果清除，新值直到用户退出字段时才提交。

	e_FlagChoiceMultiSelect = _fsdk.Field_e_FlagChoiceMultiSelect
	（仅对列表框有用）如果设置，可以同时选择多个项目； if clear, no more than one item at a time may be selected.

	e_FlagChoiceSort = _fsdk.Field_e_FlagChoiceSort
	（仅对选择字段有用）如果设置，字段的选项项应按字母顺序排序。

	e_FlagComboEdit = _fsdk.Field_e_FlagComboEdit
	（仅对组合框有用）如果设置，组合框包括带有下拉列表的可编辑文本控件，如果清除，它只包括下拉列表。

	e_FlagNoExport = _fsdk.Field_e_FlagNoExport
	如果设置，字段不能由提交表单操作导出。

	e_FlagReadOnly = _fsdk.Field_e_FlagReadOnly
	如果设置，用户不能更改字段的值。任何关联的控件注释将不会与用户交互；也就是说，它们不会响应鼠标点击或响应鼠标移动而改变外观。此标志对于其值被计算或从数据库导入的字段很有用。

	e_FlagRequired = _fsdk.Field_e_FlagRequired
	如果设置，字段在由提交表单操作导出时必须有一个值。

	e_FlagTextComb = _fsdk.Field_e_FlagTextComb
	（仅对文本字段有用）如果设置，使用梳状格式。更多...

	e_FlagTextDoNotScroll = _fsdk.Field_e_FlagTextDoNotScroll
	（仅对文本字段有用）如果设置，字段不滚动（单行字段水平滚动，多行字段垂直滚动）以容纳超出其注释矩形的更多文本。一旦字段满了，就不再接受更多文本。

	e_FlagTextFileSelect = _fsdk.Field_e_FlagTextFileSelect
	（仅对文本字段有用）如果设置，在字段中输入的文本表示文件的路径名，其内容将作为字段的值提交。

	e_FlagTextMultiline = _fsdk.Field_e_FlagTextMultiline
	（仅对文本字段有用）如果设置，文本字段可以包含多行文本；如果清除，字段的文本限制为单行。

	e_FlagTextNoSpellCheck = _fsdk.Field_e_FlagTextNoSpellCheck
	（仅对文本字段有用）如果设置，在字段中输入的文本不进行拼写检查。

	e_FlagTextPassword = _fsdk.Field_e_FlagTextPassword
	（仅对文本字段有用）如果设置，字段用于输入不应在屏幕上可见回显的安全密码。从键盘输入的字符应该以某种不可读的形式回显，例如星号或项目符号字符。更多...

	e_FlagTextRichText = _fsdk.Field_e_FlagTextRichText
	（仅对文本字段有用）如果设置，此字段的值应表示为富文本字符串。

	e_TypeCheckBox = _fsdk.Field_e_TypeCheckBox
	表单字段类型：复选框。

	e_TypeComboBox = _fsdk.Field_e_TypeComboBox
	表单字段类型：组合框。

	e_TypeListBox = _fsdk.Field_e_TypeListBox
	表单字段类型：列表框。

	e_TypePushButton = _fsdk.Field_e_TypePushButton
	表单字段类型：按钮。

	e_TypeRadioButton = _fsdk.Field_e_TypeRadioButton
	表单字段类型：单选按钮。

	e_TypeSignature = _fsdk.Field_e_TypeSignature
	表单字段类型：签名字段。

	e_TypeTextField = _fsdk.Field_e_TypeTextField
	表单字段类型：文本字段。

	e_TypeUnknown = _fsdk.Field_e_TypeUnknown
	表单字段类型：未知。

详细描述

数字签名（PDF 1.3）可用于验证用户身份和文档内容。它存储有关签名者和文档签名时状态的信息。签名包含在签名字段中，作为表单字段的一种类型，因此类Signature 派生自类FoxitPDFSDKPython3.Field 。可以通过以下函数检索/添加签名对象：

要直接从PDF文档中计数和检索为签名对象，请使用函数 FoxitPDFSDKPython3.PDFDoc.GetSignatureCount 和FoxitPDFSDKPython3.PDFDoc.GetSignature 。
要计数和检索为签名字段，当字段类型为 FoxitPDFSDKPython3.Field.e_TypeSignature 时，请使用函数 FoxitPDFSDKPython3.Form.GetFieldCount 和FoxitPDFSDKPython3.Form.GetField 。
要添加新签名，请使用函数FoxitPDFSDKPython3.PDFPage.AddSignature 。
要删除签名，请使用函数FoxitPDFSDKPython3.PDFDoc.RemoveSignature 。

在签名中，过滤器和子过滤器键用于指定将用于签名和验证签名的签名回调对象的过滤器和子过滤器。Foxit PDF SDK为以下过滤器和子过滤器提供默认签名回调：

过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.detached"
过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.sha1"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.CAdES.detached"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.RFC3161"

对于子过滤器"ETSI.CAdES.detached"和子过滤器"ETSI.RFC3161"，如果要使用默认签名回调进行签名，请确保已向TimeStampServerMgr 设置默认时间戳服务器。对于其他过滤器和子过滤器，或者如果用户想要为上述过滤器和子过滤器使用自定义签名回调，用户应准备自定义签名回调并通过函数 FoxitPDFSDKPython3.Library.RegisterSignatureCallback 将回调注册到Foxit PDF SDK。
此类提供获取/设置签名信息/属性、签名或验证签名等功能。例如：

要签名未签名的签名，请使用函数FoxitPDFSDKPython3.Signature.StartSign 。成功签名后，强烈建议用户关闭当前文档，然后打开已签名的PDF文档，然后执行后续操作。
要验证已签名签名的完整性，请使用函数FoxitPDFSDKPython3.Signature.StartVerify 。要检查已签名的签名是否有效，请参阅类LTVVerifier 。
要直接检索签名字典，请使用函数FoxitPDFSDKPython3.Signature.GetSignatureDict 。

在签名未签名的签名之前，用户可以调用以下函数来设置签名信息和签名外观：

要使用默认Foxit外观模板，相关信息可以通过 FoxitPDFSDKPython3.Signature.SetAppearanceFlags 、FoxitPDFSDKPython3.Signature.SetSignTime 、FoxitPDFSDKPython3.Signature.SetKeyValue 、 FoxitPDFSDKPython3.Signature.SetBitmap 、FoxitPDFSDKPython3.Signature.SetImage 设置。
要使用自定义外观，请通过函数 FoxitPDFSDKPython3.Signature.SetAppearanceContent 设置外观流内容。

如果未签名的签名已设置一些签名信息，但文档直接保存或在未签名的情况下关闭，这些数据（包括过滤器和子过滤器）将在保存的文档或关闭的文档中丢失。当文档再次打开时，未签名的签名需要至少指定过滤器和子过滤器进行签名；否则，此签名无法签名。

参见: FoxitPDFSDKPython3.Field; FoxitPDFSDKPython3.Form; PDFDoc; PDFPage; TimeStampServerMgr; LTVVerifier

构造及析构函数说明

◆ Signature()

def FoxitPDFSDKPython3.Signature.Signature	(	document,
		sig_field_dict
	)

构造函数，从签名字段字典创建。

参数

[in]	document	一个有效的PDF文档。
[in]	sig_field_dict	表示签名字段的PDF字典。它应该属于参数document指定的PDF文档；

成员函数说明

◆ ClearSignedData()

def FoxitPDFSDKPython3.Signature.ClearSignedData ( )

如果当前签名已签名且验证有效，清除数据和外观。

此函数用于已签名且有效的签名。
注意：从7.0开始，此函数仅用于验证签名的完整性。要检查签名是否有效，请参阅类LTVVerifier 。

返回: true表示成功清除数据和外观，false表示无需清除数据和外观或发生任何错误。

◆ EnableEmbedFont()

def FoxitPDFSDKPython3.Signature.EnableEmbedFont ( enable_embed_font )

启用或禁用嵌入字体。

参数

指示是否为签名文本嵌入字体的标志。 true表示为签名文本嵌入字体。 false表示不为签名文本嵌入字体。

返回: 无。

◆ EnableIncrementalSaveForFirstSigning()

def FoxitPDFSDKPython3.Signature.EnableIncrementalSaveForFirstSigning ( enable_incremental_save )

启用或禁用首次签名的增量保存。用户应在调用函数FoxitPDFSDKPython3.Signature.StartSign 之前调用此函数。
默认值：false。

参数

[in] enable_incremental_save 指示是否对首次签名使用增量保存的标志。 true表示对首次签名使用增量保存。 false表示对首次签名使用默认保存。

返回: 无。

◆ GenerateAppearance()

def FoxitPDFSDKPython3.Signature.GenerateAppearance ( )

生成未签名签名的外观。

此函数用于在页面上显示未签名的普通签名，而无需调用函数FoxitPDFSDKPython3.Signature.StartSign 。

返回: true表示成功，false表示失败。

被 FoxitPDFSDKPython3.PagingSealSignature 重载.

◆ GetAppearanceFlags()

def FoxitPDFSDKPython3.Signature.GetAppearanceFlags ( )

获取签名外观标志。

签名外观标志指示将显示哪些信息。目前，这仅在FoxitPDFSDKPython3.Signature.SetAppearanceFlags 成功设置后有用。对于从PDF文档获取的签名，此函数的返回值无用。

返回: 签名外观标志。请参阅从FoxitPDFSDKPython3.Signature.e_APFlagFoxitFlag 开始的值，这将是这些值中的一个或它们的组合。

◆ GetBitmap()

def FoxitPDFSDKPython3.Signature.GetBitmap ( )

获取用于签名外观的位图。

返回: 外观中使用的位图。如果返回的位图对象的函数FoxitPDFSDKPython3.Bitmap.IsEmpty 返回值为true，这意味着外观中没有使用位图或出现了错误。

◆ GetByteRangeArray()

def FoxitPDFSDKPython3.Signature.GetByteRangeArray ( out_byte_range_array )

获取字节范围数据，包括4个元素。

此函数用于已签名的签名，以检索其用于摘要计算的字节范围。字节范围数组包含4个元素。这4个元素总是成对的整数（起始字节偏移量，字节长度），描述了摘要计算的确切字节范围。
请参阅<PDF Reference 1.7>第8.7节数字签名了解更多详细信息。

参数

[out] out_byte_range_array 接收字节范围数据的输出参数。请确保此数组可以包含4个元素。

返回: true表示成功，false表示失败。

◆ GetCert()

def FoxitPDFSDKPython3.Signature.GetCert ( index )

通过索引从当前签名的证书链中获取证书。

建议在验证签名之前使用此函数。当当前签名的子过滤器为"adbe.x509.rsa_sha1"时，应用程序需要调用此函数在验证签名之前获取已验证的公共证书。证书链中的第一个证书是签名证书，可用于验证签名。

参数

[in] index 要获取的证书索引。有效范围：从0到(count-1)。 count由函数FoxitPDFSDKPython3.Signature.GetCertCount 返回。

返回: 证书。

◆ GetCertCount()

def FoxitPDFSDKPython3.Signature.GetCertCount ( )

获取当前签名证书链中的证书数量。

建议在验证签名之前使用此函数。当当前签名的子过滤器为"adbe.x509.rsa_sha1"时，应用程序需要调用此函数获取证书链中的证书数量，然后调用函数FoxitPDFSDKPython3.Signature.GetCert 在验证签名之前获取已验证的公共证书。

返回: 证书数量。

◆ GetCertificateInfo()

def FoxitPDFSDKPython3.Signature.GetCertificateInfo ( key )

获取证书信息。

此函数用于已签名的签名。目前，此函数仅支持iOS和Android平台。

参数

[in]

key

证书键字符串。目前可以是以下键之一：

"SerialNumber"
"Issuer"
"Subject"
"ValidPeriodFrom"
"ValidPeriodTo"

返回: 证书信息字符串。

注解: 对于"ValidPeriodFrom"或"ValidPeriodTo"键，时区值不会被计算在内。

◆ GetDocPermission()

def FoxitPDFSDKPython3.Signature.GetDocPermission ( )

获取当前签名的文档权限。

如果权限值不是FoxitPDFSDKPython3.Signature.e_DocPermUnrestricted ，表示当前签名已签名时添加新签名将失败
如果权限值是FoxitPDFSDKPython3.Signature.e_DocPermFillingFormAndSigning 或FoxitPDFSDKPython3.Signature.e_DocPermFillingFormSigningAndAnnotating ，表示当前签名已签名时当前签名字段的标志为只读。

返回: 文档权限。请参阅从FoxitPDFSDKPython3.Signature.e_DocPermUnrestricted 开始的值，应为这些值中的一个。

◆ GetDocument()

def FoxitPDFSDKPython3.Signature.GetDocument ( )

获取当前签名所属的PDF文档。

返回: PDF文档对象。

◆ GetFieldMDPAction()

def FoxitPDFSDKPython3.Signature.GetFieldMDPAction ( )

获取FieldMDP（"MDP"表示修改检测和预防）操作类型。

返回: FieldMDP操作类型。请参阅从FoxitPDFSDKPython3.Signature.e_FieldMDPActionNone 开始的值，应为这些值中的一个。

◆ GetFieldMDPActionFields()

def FoxitPDFSDKPython3.Signature.GetFieldMDPActionFields ( )

获取用于FieldMDP操作的字段名称数组。

返回的字段名称数组与FieldMDP操作相关（可通过函数FoxitPDFSDKPython3.Signature.GetFieldMDPAction 检查）：

如果FieldMDP操作类型为FoxitPDFSDKPython3.Signature.e_FieldMDPActionNone ，返回的字段名称数组无用。
如果FieldMDP操作类型为FoxitPDFSDKPython3.Signature.e_FieldMDPActionAll ，返回的字段名称数组将包含所有表单字段的名称。
如果FieldMDP操作类型为FoxitPDFSDKPython3.Signature.e_FieldMDPActionInclude ，返回的字段名称数组指定在当前签名签署时标志为只读的表单字段。
如果FieldMDP操作类型为FoxitPDFSDKPython3.Signature.e_FieldMDPActionExclude ，返回的字段名称数组指定在当前签名为已签名签名时标志不为只读的表单字段（但其余字段的标志为只读）。

返回: FieldMDP操作字段名称数组。

◆ GetFilter()

def FoxitPDFSDKPython3.Signature.GetFilter ( )

获取过滤器。

过滤器和子过滤器用于指定将使用哪个已注册的签名回调对象来签名/验证当前签名。

返回: 过滤器字符串。

◆ GetKeyLabel()

def FoxitPDFSDKPython3.Signature.GetKeyLabel ( label_name )

获取指定键标签的字符串。

如果当前签名是时间戳签名，此函数将始终返回空字符串。

参数

[in] label_name 键标签。请参考从FoxitPDFSDKPython3.Signature.e_LabelNameSigner 开始的值，这应该是这些值中的一个。

返回: 指定键标签的字符串。

◆ GetKeyValue()

def FoxitPDFSDKPython3.Signature.GetKeyValue ( key )

获取指定键名的字符串值。

此函数用于获取签名字典中某些键的字符串值，如"Reason"、 "Location"等。特别地，

参数

[in] key 键名。请参阅从FoxitPDFSDKPython3.Signature.e_KeyNameSigner 开始的值，应为这些值中的一个。

返回: 字符串值。

◆ GetPAdESLevel()

def FoxitPDFSDKPython3.Signature.GetPAdESLevel ( )

获取PAdES级别。

返回: PAdES级别。请参考从FoxitPDFSDKPython3.Signature.e_PAdESLevelNotPAdES 开始的值，这将是这些值中的一个。

◆ GetPagingSealGroupElements()

def FoxitPDFSDKPython3.Signature.GetPagingSealGroupElements ( )

获取当前分页印章签名的组元素。

如果当前签名类型为FoxitPDFSDKPython3.Signature.e_SignatureTypePagingSeal ，此函数将返回与当前签名关联的签名数组。否则，将返回空数组。

返回: 签名数组。

◆ GetPagingSealSignature()

def FoxitPDFSDKPython3.Signature.GetPagingSealSignature ( )

获取分页印章签名。

如果当前签名类型为FoxitPDFSDKPython3.Signature.e_SignatureTypePagingSeal ，此函数将返回与当前签名关联的分页印章签名对象。

返回: PagingSealSignature 对象。如果返回对象的函数FoxitPDFSDKPython3.Signature.IsEmpty 返回值为true，表示当前签名不是分页印章签名。

◆ GetSignatureDict()

def FoxitPDFSDKPython3.Signature.GetSignatureDict ( )

获取签名字典。

签名字典是签名字段字典的一部分。

返回: 签名字典。如果出现任何错误，此函数将返回null。

◆ GetSignatureType()

def FoxitPDFSDKPython3.Signature.GetSignatureType ( )

获取签名类型。

返回: 签名类型。请参考从FoxitPDFSDKPython3.Signature.e_SignatureTypeOrdinary 开始的值，这将是这些值中的一个。

◆ GetSignedVersionDocument()

def FoxitPDFSDKPython3.Signature.GetSignedVersionDocument ( file_path )

获取当前签名签署时的已签名版本中的PDF文档。

当PDF文档已被多个签名签署且用户想要获取其中一个签名签署时的PDF文档时，此函数很有用。

参数

[in] file_path 当前签名所属的原始打开PDF文档的完整路径。不应为空字符串。

返回: 当前签名签署时的已签名版本中的PDF文档对象。返回的PDF文档可能表示与检索当前签名的当前PDF文档不同的PDF文档，或就是当前PDF文档。用户应确保在读取或操作已签名版本文档时保持当前PDF文档对象有效。请确保返回的文档对象在使用类PDFDoc 中的大多数函数之前已成功加载。

◆ GetSignTime()

def FoxitPDFSDKPython3.Signature.GetSignTime ( )

获取签名时间。

返回: 接收签名时间的日期和时间对象。如果未找到签名时间，此函数将返回所有值为0的日期和时间对象。

◆ GetState()

def FoxitPDFSDKPython3.Signature.GetState ( )

获取当前状态。

在验证签名之前，此函数用于获取当前签名是否已签名或当前签名是否缺少签名数据的状态。
在验证签名之后，此函数用于获取验证状态–表示已验证的签名已签名；如果已验证的签名仍未签名，此函数将获取未签名状态。

返回

签名状态的值。请参阅从FoxitPDFSDKPython3.Signature.e_StateUnknown 开始的值，这将是其中一个或它们的组合。
特别地，如果返回的状态是FoxitPDFSDKPython3.Signature.e_StateNoSignData ，表示当前签名没有签名数据，请至少调用函数 FoxitPDFSDKPython3.Signature.SetKeyValue 为当前签名设置必要的过滤器和子过滤器。用户还可以在调用函数FoxitPDFSDKPython3.Signature.StartSign 之前调用以下函数来设置签名和签名外观的其他数据：

要使用默认Foxit外观模板，相关信息可以通过 FoxitPDFSDKPython3.Signature.SetAppearanceFlags 、FoxitPDFSDKPython3.Signature.SetSignTime 、 FoxitPDFSDKPython3.Signature.SetKeyValue 、FoxitPDFSDKPython3.Signature.SetBitmap 、FoxitPDFSDKPython3.Signature.SetImage 设置。
要使用自定义外观，请通过函数 FoxitPDFSDKPython3.Signature.SetAppearanceContent 设置外观流内容。

◆ GetSubFilter()

def FoxitPDFSDKPython3.Signature.GetSubFilter ( )

获取子过滤器。

过滤器和子过滤器用于指定将使用哪个已注册的签名回调对象来签名/验证当前签名。

返回: 子过滤器字符串。

◆ IsEmpty()

def FoxitPDFSDKPython3.Signature.IsEmpty ( )

检查当前对象是否为空。

当前对象为空时，表示当前对象无用。

返回: true表示当前对象为空，false表示不为空。

重载 FoxitPDFSDKPython3.Field .

◆ IsSigned()

def FoxitPDFSDKPython3.Signature.IsSigned ( )

检查当前签名是否已签名。

返回: true表示当前签名已签名，false表示未签名。

◆ IsTimeStamp()

def FoxitPDFSDKPython3.Signature.IsTimeStamp ( )

检查当前签名是否为时间戳签名。

返回: true表示当前签名是时间戳签名，false表示不是。

◆ SetAppearanceContent()

def FoxitPDFSDKPython3.Signature.SetAppearanceContent ( appearance_content )

为已签名签名外观设置自定义外观内容（作为低级绘图操作命令）。

此函数只能在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用。
一旦设置了自定义外观内容，它将用作已签名外观。在这种情况下，由FoxitPDFSDKPython3.Signature.SetAppearanceFlags 设置的外观标志将被忽略，相关信息将不会在外观中使用——这些信息由以下函数设置： FoxitPDFSDKPython3.Signature.SetSignTime 、FoxitPDFSDKPython3.Signature.SetKeyValue （过滤器和子过滤器除外）、 FoxitPDFSDKPython3.Signature.SetBitmap 、FoxitPDFSDKPython3.Signature.SetImage 。
如果当前签名是时间戳签名，此函数将不执行任何操作。

参数

[in] appearance_content 自定义外观内容。这应该是用于外观的绘制操作命令序列，例如"10 10 m 20 10 l S"。请参考<PDF Reference 1.7> P196了解更多详情。

返回: None.

◆ SetAppearanceFlags()

def FoxitPDFSDKPython3.Signature.SetAppearanceFlags ( appearance_flags )

设置签名外观标志。

建议在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用此函数。
签名外观标志指示在已签名外观中将显示哪些信息。如果已通过函数FoxitPDFSDKPython3.Signature.SetAppearanceContent 设置自定义外观内容，外观标志将被忽略。
如果当前签名是时间戳签名，此函数将不执行任何操作。

参数

[in] appearance_flags 签名外观标志。请参阅从 FoxitPDFSDKPython3.Signature.e_APFlagFoxitFlag 开始的值，应为这些值中的一个或它们的组合。

返回: 无。

◆ SetBitmap()

def FoxitPDFSDKPython3.Signature.SetBitmap ( bitmap )

为签名外观设置位图。

建议在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用此函数。如果已通过函数FoxitPDFSDKPython3.Signature.SetAppearanceContent 设置了自定义外观内容，则位图将不会在已签名外观中使用。
如果当前签名是时间戳签名，此函数将不执行任何操作。

参数

[in] bitmap 要设置到外观的位图。它应该是有效的。

返回: None.

◆ SetCertChain()

def FoxitPDFSDKPython3.Signature.SetCertChain ( cert_chain )

设置证书链。

建议在签名未签名的签名之前使用此函数。当签名子过滤器为"adbe.x509.rsa_sha1"时，用户需要调用此函数将证书链设置到签名中。对于其他子过滤器，此函数将直接返回而不执行任何操作。

参数

[in] cert_chain 表示证书链的字符串数组。

返回: None.

◆ SetCustomObject()

def FoxitPDFSDKPython3.Signature.SetCustomObject	(	key,
		pdf_object
	)

为签名字典设置自定义PDF对象。

建议在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用此函数。

参数

[in]	key	签名字典的键，将设置其值元素。不应为空字符串。
[in]	pdf_object	要设置为键值的自定义PDFObject 对象。不应为null。它可以是直接PDF对象或间接PDF对象。

返回: None.

◆ SetDefaultContentsLength()

def FoxitPDFSDKPython3.Signature.SetDefaultContentsLength ( default_length )

设置表示签名值（称为已签名数据）的签名内容的默认长度。

此函数只能在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用。
签名内容表示签名值（称为已签名数据）。初始化签名字段时，签名内容将以默认长度7942初始化。当使用自定义签名回调来签名和验证未签名的签名时，用户可以调用此函数来更改签名内容的默认长度。在这种情况下，用户还应确保回调函数FoxitPDFSDKPython3.SignatureCallback.Sign 中返回的已签名数据的长度不应大于此函数设置的默认长度。

参数

[in] default_length 签名值（称为已签名数据）的默认长度，以字节为单位。不应小于4098。

返回: None.

◆ SetDocPermission()

def FoxitPDFSDKPython3.Signature.SetDocPermission ( permission )

设置当前签名的文档权限。

此函数仅对未签名的签名有用。如果对已签名的签名使用此函数，则不会执行任何操作。
关于权限值的一些注意事项：

如果为当前未签名的签名设置除FoxitPDFSDKPython3.Signature.e_DocPermUnrestricted 之外的任何权限值，则当当前签名为已签名签名时，添加新签名将失败。
如果为当前未签名的签名设置权限值FoxitPDFSDKPython3.Signature.e_DocPermFillingFormAndSigning 或FoxitPDFSDKPython3.Signature.e_DocPermFillingFormSigningAndAnnotating ，则FieldMDP操作将为FoxitPDFSDKPython3.Signature.e_FieldMDPActionInclude ，且当当前签名为已签名签名时，当前签名字段的标志将为只读。

参数

[in] permission 文档权限。请参阅从FoxitPDFSDKPython3.Signature.e_DocPermUnrestricted 开始的值，应为这些值中的一个。

返回: 无。

◆ SetFieldMDPActionFields()

def FoxitPDFSDKPython3.Signature.SetFieldMDPActionFields	(	action,
		field_array
	)

设置FieldMDP（"MDP"表示修改检测和预防）操作名称数组。

此函数仅对未签名的签名有用。如果对已签名的签名使用此函数，则不会执行任何操作。
如果当前签名已签名，此函数无效。

参数

[in]	action	FieldMDP操作类型。请参阅从FoxitPDFSDKPython3.Signature.e_FieldMDPActionNone 开始的值，应为这些值中的一个。如果此值为FoxitPDFSDKPython3.Signature.e_FieldMDPActionNone ，表示不使用FieldMDP操作。如果此值为FoxitPDFSDKPython3.Signature.e_FieldMDPActionAll ，参数field_array将被忽略，所有字段将包含在对象摘要中（因此在当前签名签署后不允许更改）。如果此值为FoxitPDFSDKPython3.Signature.e_FieldMDPActionInclude ，表示只有参数field_array指定的表单字段的标志将被设置为只读，这些字段将包含在对象摘要中（因此在当前签名签署后不允许更改）。如果此值为FoxitPDFSDKPython3.Signature.e_FieldMDPActionExclude ，表示表单字段（除参数field_array指定的字段外）的标志将被设置为只读，这些字段包含在对象摘要中（因此在当前签名签署后不允许更改）。
[in]	field_array	用于FieldMDP操作的字段名称数组。

返回: 无。

◆ SetFilter()

def FoxitPDFSDKPython3.Signature.SetFilter ( filter )

设置过滤器。

过滤器和子过滤器用于指定将使用哪个已注册的签名回调对象来签名/验证当前签名。用户应设置过滤器和子过滤器以使用Foxit PDF SDK中的默认签名回调，或使用其他过滤器和子过滤器，但请确保在签名或验证当前签名之前，具有非默认过滤器和子过滤器的签名回调对象已在Foxit PDF SDK中注册。默认签名回调的过滤器和子过滤器是：

过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.detached"
过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.sha1"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.CAdES.detached"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.RFC3161"

参数

[in] filter 过滤器字符串。不能为空字符串。

返回: 无。

◆ SetImage() [1/2]

def FoxitPDFSDKPython3.Signature.SetImage	(	file_path,
		frame_index
	)

使用指定帧索引为签名外观设置图像。

建议在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用此函数。如果已通过函数FoxitPDFSDKPython3.Signature.SetAppearanceContent 设置了自定义外观内容，则图像将不会在已签名外观中使用。
输入图像可能包含多个帧，只能将图像的一帧设置到当前签名。
如果当前签名是时间戳签名，此函数将不执行任何操作。

参数

[in]	file_path	现有图像文件的完整路径。不应为空字符串。
[in]	frame_index	帧索引。有效范围：从0到(count-1)。 count由输入图像文件的函数FoxitPDFSDKPython3.Image.GetFrameCount 返回。

返回: None.

◆ SetImage() [2/2]

def FoxitPDFSDKPython3.Signature.SetImage	(	image,
		frame_index
	)

为签名外观设置图像，指定帧索引。

建议在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用此函数。如果已通过函数FoxitPDFSDKPython3.Signature.SetAppearanceContent 设置了自定义外观内容，则图像将不会在已签名外观中使用。
输入图像可能包含多个帧，只能将图像的一帧设置到当前签名。
如果当前签名是时间戳签名，此函数将不执行任何操作。

参数

[in]	image	图像。它的一帧将设置到当前签名。此图像至少包含一帧，图像类型不应为FoxitPDFSDKPython3.Image.e_Unknown 。
[in]	frame_index	帧索引。有效范围：从0到(count-1)。 count由函数FoxitPDFSDKPython3.Image.GetFrameCount 返回。

返回: None.

◆ SetKeyLabel()

def FoxitPDFSDKPython3.Signature.SetKeyLabel	(	label_name,
		label_value
	)

设置指定键标签的字符串。

建议在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用此函数。
此函数用于设置签名字典中某些键的自定义标签的字符串值。如果未设置自定义标签，Foxit PDF SDK将使用默认标签。请参阅从FoxitPDFSDKPython3.Signature.e_LabelNameSigner 开始的值的注释了解更多详细信息。
如果当前签名是时间戳签名，此函数将不执行任何操作。

参数

[in]	label_name	键标签。请参阅从FoxitPDFSDKPython3.Signature.e_LabelNameSigner 开始的值，应为这些值中的一个。
[in]	label_value	键标签的新字符串值。如果这是空字符串，Foxit PDF SDK将使用默认标签。请参阅从FoxitPDFSDKPython3.Signature.e_LabelNameSigner 开始的值的注释了解更多详细信息。

返回: 无。

◆ SetKeyValue()

def FoxitPDFSDKPython3.Signature.SetKeyValue	(	key,
		value
	)

设置指定键名的字符串值。

建议在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用此函数。
此函数用于设置签名字典中某些键的字符串值，如签名者、原因、位置等。
如果当前签名是时间戳签名，此函数将不执行任何操作。

参数

[in]	key	键名。请参阅从FoxitPDFSDKPython3.Signature.e_KeyNameSigner 开始的值，应为这些值中的一个。
[in]	value	新的字符串值。

返回: 无。

◆ SetSignTime()

def FoxitPDFSDKPython3.Signature.SetSignTime ( sign_time )

设置签名时间。

建议在为未签名的签名调用函数FoxitPDFSDKPython3.Signature.StartSign 之前使用此函数。

参数

[in] sign_time 签名时间。

返回: 无。

◆ SetSubFilter()

def FoxitPDFSDKPython3.Signature.SetSubFilter ( sub_filter )

设置子过滤器。

过滤器和子过滤器用于指定将使用哪个已注册的签名回调对象来签名/验证当前签名。用户应设置过滤器和子过滤器以使用Foxit PDF SDK中的默认签名回调，或使用其他过滤器和子过滤器，但请确保在签名或验证当前签名之前，具有非默认过滤器和子过滤器的签名回调对象已在Foxit PDF SDK中注册。默认签名回调的过滤器和子过滤器是：

过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.detached"
过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.sha1"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.CAdES.detached"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.RFC3161"

参数

[in] sub_filter 子过滤器字符串。

返回: 无。

◆ StartSign() [1/3]

def FoxitPDFSDKPython3.Signature.StartSign	(	cert_file_stream,
		cert_password,
		digest_algorithm,
		save_path,
		client_data,
		pause
	)

如果当前签名是未签名的，开始签名当前签名。

此函数用于未签名的签名。当前签名的过滤器和子过滤器键指定将用于签名当前签名的签名回调对象的名称。因此在签名之前，请确保当前签名具有有效的过滤器和子过滤器字符串值。如果过滤器和子过滤器是以下字符串之一，表示使用Foxit PDF SDK中的默认签名回调：

过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.detached"
过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.sha1"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.CAdES.detached"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.RFC3161"

对于其他过滤器和子过滤器，或者如果用户想要为上述过滤器和子过滤器使用自定义签名回调，请确保已通过函数FoxitPDFSDKPython3.Library.RegisterSignatureCallback 将自定义签名回调注册到Foxit PDF SDK。
对于符合PDF/A规范的PDF文档，建议调用FoxitPDFSDKPython3.Library.SetDefaultICCProfilesPath 并在调用当前函数之前通过调用FoxitPDFSDKPython3.Signature.EnableEmbedFont 启用字体嵌入。签名可能需要很长时间，因此Foxit PDF SDK使用渐进式处理来完成此操作。

参数

[in]	cert_file_stream	用户实现的FoxitPDFSDKPython3.StreamCallback 对象，用于访问将用于签名的证书文件的内容。 This can be null if not necessary in custom signature callback. 如果在自定义签名回调中不需要，这可以为null。如果将使用默认签名回调来签名当前签名，可以使用PFX证书文件。
[in]	cert_password	用于打开证书文件的密码字符串。如果这是空字符串，表示不需要密码。
[in]	digest_algorithm	签名数据的消息摘要算法。请参考从 FoxitPDFSDKPython3.Signature.e_DigestSHA1 开始的值，这应该是这些值中的一个。
[in]	save_path	用于保存签名结果的完整PDF文件路径。已签名的文档将保存到另一个PDF文件。
[in]	client_data	用户定义的对象，将传递给SignatureCallback 中的回调函数。如果将使用默认回调对象来签名当前签名，这是无用的。默认值：null。
[in]	pause	决定签名过程是否需要暂停的暂停对象。这可以是 null，表示在签名过程中不暂停。如果这不是 null，它应该是用户实现的有效暂停对象。默认值：null。

返回: 渐进式对象。请通过函数FoxitPDFSDKPython3.Progressive.GetRateOfProgress 检查当前进度的比率。如果比率还没有达到100，调用函数FoxitPDFSDKPython3.Progressive.Continue 继续进度，直到进度完成。

注解

此函数不支持将已签名的PDF文档直接保存到用于构造当前签名相关PDF文档的PDF文件中。为了实现这一点，建议用户按照以下步骤操作：
假设相关的PDF文档对象是从名为"org.pdf"的PDF文件构造的。

使用当前函数将签名结果保存到临时文件。在这里，此临时文件命名为"temp.tmp"。
确保相关的PDF文档对象已析构——这等同于"关闭文档"。
删除"org.pdf"并将"temp.tmp"重命名为"org.pdf"。

然后用户可以打开已签名的PDF文档进行其他操作。

◆ StartSign() [2/3]

def FoxitPDFSDKPython3.Signature.StartSign	(	cert_file_stream,
		cert_password,
		digest_algorithm,
		stream_callback,
		client_data,
		pause
	)

如果当前签名为未签名状态，则开始签名当前签名。

此函数用于未签名的签名对象。当前签名的过滤器和子过滤器键指定了用于签名当前签名的签名回调对象的名称。因此在签名之前，请确保当前签名具有有效的过滤器和子过滤器字符串值。如果过滤器和子过滤器是以下字符串之一，意味着使用Foxit PDF SDK中的默认签名回调：

filter: "Adobe.PPKLite" and sub filter: "adbe.pkcs7.detached"
filter: "Adobe.PPKLite" and sub filter: "adbe.pkcs7.sha1"
filter: "Adobe.PPKLite" and sub filter: "ETSI.CAdES.detached"
filter: "Adobe.PPKLite" and sub filter: "ETSI.RFC3161"

对于子过滤器"ETSI.CAdES.detached"和子过滤器"ETSI.RFC3161"，如果要使用它们的默认签名回调进行签名，请确保已向TimeStampServerMgr 设置默认的时间戳服务器。对于其他过滤器和子过滤器，或者如果用户想要为上述过滤器和子过滤器使用自定义签名回调，请确保已通过函数FoxitPDFSDKPython3.Library.RegisterSignatureCallback 向Foxit PDF SDK注册自定义签名回调。
对于符合PDF/A规范的PDF文档，建议在调用当前函数之前调用FoxitPDFSDKPython3.Library.SetDefaultICCProfilesPath 并通过调用FoxitPDFSDKPython3.Signature.EnableEmbedFont 启用字体嵌入。签名操作可能需要很长时间，因此Foxit PDF SDK使用渐进式处理来完成此操作。

参数

[in]	cert_file_stream	用户实现的FoxitPDFSDKPython3.StreamCallback 对象，用于访问将用于签名的证书文件内容。如果在自定义签名回调中不需要，这可以是null。如果要使用默认签名回调来签名当前签名，可以使用PFX证书文件。
[in]	cert_password	用于打开证书文件的密码字符串。如果这是空字符串，表示不需要密码。
[in]	digest_algorithm	签名数据的消息摘要算法。请参考从FoxitPDFSDKPython3.Signature.e_DigestSHA1 开始的值，这应该是这些值中的一个。
[in]	stream_callback	用户实现的FoxitPDFSDKPython3.StreamCallback 对象，用于保存签名结果。已签名的文档将保存到另一个PDF文件。
[in]	client_data	用户定义的对象，将传递给SignatureCallback 中的回调函数。如果使用默认回调对象来签名当前签名，则此参数无用。默认值：null。
[in]	pause	决定签名过程是否需要暂停的暂停对象。这可以是 null，表示在签名过程中不暂停。如果不为 null，它应该是用户实现的有效暂停对象。默认值：null。

返回: 渐进式对象。请通过函数FoxitPDFSDKPython3.Progressive.GetRateOfProgress 检查当前进度率。如果进度率还不是100，请调用函数FoxitPDFSDKPython3.Progressive.Continue 继续进度，直到进度完成。

注解

此函数不支持将已签名的PDF文档直接保存到用于构建当前签名相关PDF文档的PDF文件中。为了做到这一点，建议用户执行以下步骤：
假设相关的PDF文档对象是从名为"org.pdf"的PDF文件构建的。

使用当前函数将签名结果保存到临时文件。这里，此临时文件命名为"temp.tmp"。
确保相关的PDF文档对象已析构——这等同于"关闭文档"。
删除"org.pdf"并将"temp.tmp"重命名为"org.pdf"。

然后用户可以打开已签名的PDF文档进行其他操作。

◆ StartSign() [3/3]

def FoxitPDFSDKPython3.Signature.StartSign	(	cert_path,
		cert_password,
		digest_algorithm,
		stream_callback,
		client_data,
		pause
	)

如果当前签名为未签名状态，则开始签名当前签名。

此函数用于未签名的签名对象。当前签名的过滤器和子过滤器键指定了用于签名当前签名的签名回调对象的名称。因此在签名之前，请确保当前签名具有有效的过滤器和子过滤器字符串值。如果过滤器和子过滤器是以下字符串之一，意味着使用Foxit PDF SDK中的默认签名回调：

过滤器: "Adobe.PPKLite" 和子过滤器: "adbe.pkcs7.detached"
过滤器: "Adobe.PPKLite" 和子过滤器: "adbe.pkcs7.sha1"
过滤器: "Adobe.PPKLite" 和子过滤器: "ETSI.CAdES.detached"
过滤器: "Adobe.PPKLite" 和子过滤器: "ETSI.RFC3161"

对于子过滤器"ETSI.CAdES.detached"和子过滤器"ETSI.RFC3161"，如果要使用它们的默认签名回调进行签名，请确保已向TimeStampServerMgr 设置默认的时间戳服务器。对于其他过滤器和子过滤器，或者如果用户想要为上述过滤器和子过滤器使用自定义签名回调，请确保已通过函数FoxitPDFSDKPython3.Library.RegisterSignatureCallback 向Foxit PDF SDK注册自定义签名回调。
对于符合PDF/A规范的PDF文档，建议在调用当前函数之前调用FoxitPDFSDKPython3.Library.SetDefaultICCProfilesPath 并通过调用FoxitPDFSDKPython3.Signature.EnableEmbedFont 启用字体嵌入。签名操作可能需要很长时间，因此Foxit PDF SDK使用渐进式处理来完成此操作。

参数

[in]	cert_path	证书文件的完整路径（包括文件名和扩展名），将用于签名。如果在自定义签名回调中不需要，这可以是空字符串。当此文件路径不为空时，它应该是有效路径。如果要使用默认签名回调来签名当前签名，这可以是PFX证书文件。
[in]	cert_password	用于打开证书文件的密码字符串。如果这是空字符串，表示不需要密码。
[in]	digest_algorithm	签名数据的消息摘要算法。请参考从FoxitPDFSDKPython3.Signature.e_DigestSHA1 开始的值，这应该是这些值中的一个。
[in]	stream_callback	用户实现的FoxitPDFSDKPython3.StreamCallback 对象，用于保存签名结果。已签名的文档将保存到另一个PDF文件。
[in]	client_data	用户定义的对象，将传递给SignatureCallback 中的回调函数。如果使用默认回调对象来签名当前签名，则此参数无用。默认值：null。
[in]	pause	决定签名过程是否需要暂停的暂停对象。这可以是 null，表示在签名过程中不暂停。如果不为 null，它应该是用户实现的有效暂停对象。默认值：null。

返回: 渐进式对象。请通过函数FoxitPDFSDKPython3.Progressive.GetRateOfProgress 检查当前进度率。如果进度率还不是100，请调用函数FoxitPDFSDKPython3.Progressive.Continue 继续进度，直到进度完成。

注解

此函数不支持将已签名的PDF文档直接保存到用于构建当前签名相关PDF文档的PDF文件中。为了做到这一点，建议用户执行以下步骤：
假设相关的PDF文档对象是从名为"org.pdf"的PDF文件构建的。

使用当前函数将签名结果保存到临时文件。这里，此临时文件命名为"temp.tmp"。
确保相关的PDF文档对象已析构——这等同于"关闭文档"。
删除"org.pdf"并将"temp.tmp"重命名为"org.pdf"。

然后用户可以打开已签名的PDF文档进行其他操作。

◆ StartVerify()

def FoxitPDFSDKPython3.Signature.StartVerify	(	client_data,
		pause
	)

如果当前签名已签名，开始验证当前签名的完整性。

此函数用于已签名的签名。当前签名的过滤器和子过滤器键指定将用于验证当前签名的签名回调对象的名称。因此在验证之前，请确保：必要的签名回调对象已通过函数 FoxitPDFSDKPython3.Library.RegisterSignatureCallback 注册。如果当前已签名签名的过滤器和子过滤器是以下字符串之一，表示使用Foxit PDF SDK中的默认签名回调，用户无需为它们注册：

过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.detached"
过滤器："Adobe.PPKLite"和子过滤器："adbe.pkcs7.sha1"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.CAdES.detached"
过滤器："Adobe.PPKLite"和子过滤器："ETSI.RFC3161"

验证签名可能需要很长时间，因此Foxit PDF SDK使用渐进过程来执行此操作。
从7.0开始，此函数仅用于验证签名的完整性。要检查签名是否有效，请参阅类LTVVerifier 。

参数

[in]	client_data	用户定义对象，将传递给SignatureCallback 中的回调函数。如果要使用默认回调对象来验证当前签名，则此参数无用。默认值：null。
[in]	pause	决定验证过程是否需要暂停的暂停对象。可以为null，表示在验证过程中不暂停。如果不为null，应为用户实现的有效暂停对象。默认值：null。

返回: 渐进对象。请通过函数FoxitPDFSDKPython3.Progressive.GetRateOfProgress 检查当前进度的比率。如果比率尚未达到100，调用函数FoxitPDFSDKPython3.Progressive.Continue 继续进度，直到进度完成。

类成员变量说明

◆ e_FieldMDPActionExclude

FoxitPDFSDKPython3.Signature.e_FieldMDPActionExclude = _fsdk.Signature_e_FieldMDPActionExclude

static

表单字段（除指定表单字段外）的标志将被设置为只读。

注解: "指定表单字段"可以通过函数FoxitPDFSDKPython3.Signature.GetFieldMDPActionFields 和FoxitPDFSDKPython3.Signature.SetFieldMDPActionFields 获取/设置。有关更多详细信息，请参阅这些函数。

◆ e_FieldMDPActionInclude

FoxitPDFSDKPython3.Signature.e_FieldMDPActionInclude = _fsdk.Signature_e_FieldMDPActionInclude

static

指定表单字段的标志将被设置为只读。

注解: "指定表单字段"可以通过函数FoxitPDFSDKPython3.Signature.GetFieldMDPActionFields 和FoxitPDFSDKPython3.Signature.SetFieldMDPActionFields 获取/设置。有关更多详细信息，请参阅这些函数。

◆ e_LabelNameDN

FoxitPDFSDKPython3.Signature.e_LabelNameDN = _fsdk.Signature_e_LabelNameDN

static

专有名称的签名键名。

注解: Foxit PDF SDK中专有名称的默认标签名称是"DN: "。

◆ e_LabelNameLocation

FoxitPDFSDKPython3.Signature.e_LabelNameLocation = _fsdk.Signature_e_LabelNameLocation

static

位置的签名标签名称。

注解: Foxit PDF SDK中位置的默认标签名称是"Location: "。

◆ e_LabelNameProducer

FoxitPDFSDKPython3.Signature.e_LabelNameProducer = _fsdk.Signature_e_LabelNameProducer

static

生产者名称的签名键名。

注解: Foxit PDF SDK中生产者名称的默认标签名称为空。

◆ e_LabelNameReason

FoxitPDFSDKPython3.Signature.e_LabelNameReason = _fsdk.Signature_e_LabelNameReason

static

原因的签名标签名称。

注解: Foxit PDF SDK中原因的默认标签名称是"Reason: "。

◆ e_LabelNameSigner

FoxitPDFSDKPython3.Signature.e_LabelNameSigner = _fsdk.Signature_e_LabelNameSigner

static

签名者的签名标签名称。

注解: Foxit PDF SDK中签名者的默认标签名称是"Digitally signed by "。

◆ e_LabelNameSignTime

FoxitPDFSDKPython3.Signature.e_LabelNameSignTime = _fsdk.Signature_e_LabelNameSignTime

static

签名时间的签名标签名称。

注解: Foxit PDF SDK中签名时间的默认标签名称是"Date: "。

Public 成员函数

静态 Public 属性

详细描述

构造及析构函数说明

◆ Signature()

成员函数说明

◆ ClearSignedData()

◆ EnableEmbedFont()

◆ EnableIncrementalSaveForFirstSigning()

◆ GenerateAppearance()

◆ GetAppearanceFlags()

◆ GetBitmap()

◆ GetByteRangeArray()

◆ GetCert()

◆ GetCertCount()

◆ GetCertificateInfo()

◆ GetDocPermission()

◆ GetDocument()

◆ GetFieldMDPAction()

◆ GetFieldMDPActionFields()

◆ GetFilter()

◆ GetKeyLabel()

◆ GetKeyValue()

◆ GetPAdESLevel()

◆ GetPagingSealGroupElements()

◆ GetPagingSealSignature()

◆ GetSignatureDict()

◆ GetSignatureType()

◆ GetSignedVersionDocument()

◆ GetSignTime()

◆ GetState()

◆ GetSubFilter()

◆ IsEmpty()

◆ IsSigned()

◆ IsTimeStamp()

◆ SetAppearanceContent()

◆ SetAppearanceFlags()

◆ SetBitmap()

◆ SetCertChain()

◆ SetCustomObject()

◆ SetDefaultContentsLength()

◆ SetDocPermission()

◆ SetFieldMDPActionFields()

◆ SetFilter()

◆ SetImage() [1/2]

◆ SetImage() [2/2]

◆ SetKeyLabel()

◆ SetKeyValue()

◆ SetSignTime()

◆ SetSubFilter()

◆ StartSign() [1/3]

◆ StartSign() [2/3]

◆ StartSign() [3/3]

◆ StartVerify()

类成员变量说明

◆ e_FieldMDPActionExclude

◆ e_FieldMDPActionInclude

◆ e_LabelNameDN

◆ e_LabelNameLocation

◆ e_LabelNameProducer

◆ e_LabelNameReason

◆ e_LabelNameSigner

◆ e_LabelNameSignTime